home *** CD-ROM | disk | FTP | other *** search
/ Power Utilities / Power Utilities.iso / utility / pro185 / colorset.doc < prev    next >
Encoding:
Text File  |  1993-09-20  |  7.0 KB  |  151 lines
  1.  
  2.  
  3.                             ╔════════════════════╗
  4.                             ║    ColorSet.Doc    ║
  5.                             ╚════════════════════╝
  6.  
  7.  
  8.                                     ColorSet
  9.                        Copyright (c) 1993 Sheldon L. Sobel
  10.  
  11.                               Color Setting Utility
  12.  
  13.            For a variety or reasons you may want to change the color
  14.            displayed on your screen.  An application may not reset the
  15.            colors to the original values when it ends.  You want to
  16.            "color code" screens as a means of tracking progress of a
  17.            process (i. e. "When we start the screen is green, at the
  18.            conversion step its brown, ... ,when the process is finished
  19.            we see a blue screen.  If we observe a red screen with yellow
  20.            characters, an error has occurred.  I can monitor from my desk
  21.            across the room, I don't need to read the screen.")
  22.  
  23.            ColorSet is designed to allow you to easily change the screen
  24.            color of PC's which have a color video card and color monitor.
  25.            You may execute ColorSet from either within batch file or
  26.            interactively at the DOS command prompt.  Two modes of operation
  27.            are available: menu mode and command line mode.
  28.  
  29.  
  30.         I. Menu Mode.
  31.  
  32.            Menu mode is selected by typing ColorSet and then pressing the
  33.            Enter key, thus displaying the menu of valid ColorSet options.
  34.            Menu mode accepts numbers for associated color names from which
  35.            selections are chosen.  Selections are then displayed so that
  36.            you may evaluate various combinations.  Continue to compare
  37.            background and foreground color pairs until a satisfactory
  38.            combination is selected and accepted.
  39.  
  40.  
  41.        II. Command Line Mode.
  42.  
  43.             Syntax:  COLORSET Background-Color Foreground-Color[*]
  44.  
  45.            The brackets around the asterisk indicates that this is an
  46.            optional parameter; the brackets should not be included in the
  47.            command line.  The location of the asterisk is not limited to
  48.            the last position as shown in the above syntax but may occur
  49.            anywhere after the initial space separator.  The purpose of the
  50.            asterisk is to specify that a high intensity (e.g. "bright")
  51.            foreground color is required.
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.             ■ Background-Color is limited to the eight colors defined below.
  59.  
  60.             ■ Foreground-Color may be any of the sixteen colors in its list.
  61.  
  62.             ■ Either upper case or lower case characters are acceptable.
  63.  
  64.             ■ Color names may be abbreviated to their first three characters.
  65.  
  66.             Background Color Choices         Foreground Color Choices
  67.             ────────────────────────         ────────────────────────
  68.                      BLAck                       BLAck       GRAy
  69.                      BLUe                        BLUe       *BLUe
  70.                      GREen                       GREen      *GREen
  71.                      CYAn                        CYAn       *CYAn
  72.                      RED                         RED        *RED
  73.                      MAGenta                     MAGenta    *MAGenta
  74.                      BROwn                       BROwn       YELlow
  75.                      WHIte                       WHIte      *WHIte
  76.  
  77.             Examples of valid requests:
  78.                 ColorSet  BLUE White
  79.                 ColorSet  WHITE mag
  80.                 ColorSet  MAG YEL
  81.                 ColorSet  Bro *mag       ; bright magenta is indicated
  82.                 ColorSet  mag blu*       ; bright blue is indicated
  83.  
  84.  
  85.             Examples of invalid requests:
  86.                 ColorSet  White with BLU  ; Syntax error
  87.                 ColorSet  Blue  *YELL     ; No such color as "bright" Yellow
  88.                 ColorSet  Meg White       ; Nice girl but no color
  89.  
  90.                 Note: Invalid requests result in ColorSet defaulting to
  91.                       menu mode.
  92.  
  93.       III. Miscellaneous.
  94.  
  95.            ColorSet must be located in a directory in the search path.
  96.  
  97.            Selection of identical Background/Foreground color pairs are
  98.            allowed.  When in menu mode and this condition occurs, the
  99.            following message is displayed:  "You have selected a combination
  100.            which displays a completely blank screen.  Do you want to set this
  101.            color?"  This allows an opportunity to cancel the request.  In
  102.            command line mode no such verification is provided, the request
  103.            is accepted and executed without question. If you elect to use
  104.            this "blank screen" option, it is recommended that you first set
  105.            your working directory to an empty directory to protect against
  106.            the casual browser typing on what appears to be an inactive system
  107.            possibly modifying and deleting files.
  108.  
  109.  
  110.            If you want the same color combination displayed each time you
  111.            start your PC:
  112.  
  113.                 1. Run ColorSet in menu mode, rejecting color pairs, until
  114.                    you find the desired combination.
  115.  
  116.                 2. Determine the equivalent ColorSet line mode command to
  117.                    verify syntax and color combination.
  118.  
  119.                 3. Edit your AUTOEXEC.BAT file and append to it the command
  120.                    string determined in step 2.  If you also want a blank
  121.                    screen to be displayed at that time, add a second line
  122.                    containing the DOS screen clearing command CLS.
  123.  
  124.                    Adding a ColorSet command followed by the CLS command to
  125.                    any batch command file, obviously, will display the entire
  126.                    screen in the new colors.  Without the CLS command the
  127.                    screen is not cleared, the previous screen restores except
  128.                    for the current line and the new color attributes are in
  129.                    effect at this time.  An example, ColorsEx.Bat, is included
  130.                    in this distribution.
  131.  
  132.            ColorSho.Exe is also included in this distribution.  When
  133.            executed 120 named color combinations are displayed for your
  134.            evaluation.  Observe the one which you want displayed and then
  135.            set it with ColorSet.  ColorSho does not display the eight screen
  136.            blanking combinations where the foreground and background colors
  137.            are identical.
  138.  
  139.            ColorSet is offered "as is".  No warranty nor claim of any kind is
  140.            made nor implied.
  141.  
  142.            If you obtained you copy of ColorSet.Exe other than as part of a
  143.            registered WYWA distribution set, a payment of $5.00 is requested.
  144.  
  145.            Suggestions, comments, or any other messages may be directed to
  146.            the author:
  147.  
  148.                    Sheldon L. Sobel          Tel: (603) 424-2085
  149.                    46 Joppa Road             CompuServe ID: 73770,2160
  150.                    Merrimack, NH 03054
  151.